初心者向け実践ガイド - 初心者がよく見落とす注意点付き
（株）PARA-TECH 2025年10月 V1.0
Claude CodeはAnthropicが開発した革新的なプログラミングツールです。ターミナル上で直接動作し、自然言語の指示でコード生成、デバッグ、リファクタリングが可能です。
自然言語の説明から完全なコード生成
エラーメッセージを分析して修正案を提示
複雑なコードベースの詳細な説明
コード品質の向上と最適化
ユニットテストと統合テストの自動生成
コメントとREADMEの自動生成
MacまたはLinuxの場合はターミナル、Windowsの場合はコマンドプロンプトまたはPowerShellを開きます。
cd /path/to/your-project
claude
初回使用時はClaudeアカウントでログインします。Claude.aiアカウント、またはClaude Console（企業向け）を使用できます。
claude コマンドを実行してください。違うディレクトリで起動すると、別のプロジェクトが表示されます。
Claude.ai アカウント（個人向け）
Claude Console アカウント（企業向け）
グラフィカルインターフェースを好む場合は、VS Code 拡張機能がベータ版で利用可能です。
このワークフローは最良の結果を生み出します。特に複雑な機能開発に推奨されます。
Claude に現在のコード構造を分析させ、実装ステップを列挙させます。
例：「現在のコード構造を分析した上で、OAuth2認証を実装するステップを列挙してください」
提案された計画をチーム内で検討し、修正が必要な点があれば指摘します。
例：「計画は良さそうですが、認証にはJWTトークンを使用してください」
計画が確定したら、Claude に実装させます。
例：「計画に従って実装してください。エラーハンドリングを忘れずに」
テストを追加し、変更内容をコミット、PRを作成します。
例：「このエラーが出ています：[エラーメッセージをペースト]」
Claude がエラーを分析して直接修正を提案します。
推奨シーン： ほとんどの開発タスク
| キー | 動作 | 用途 |
|---|---|---|
Escape |
現在の操作を中断 | Claude が何かしている途中に方向を変えたい時 |
Double Escape |
/rewind を開く | 前の状態に戻って別の方法を試す |
Shift + Tab |
自動受け入れモード切替 | 確認をスキップして自動実行 |
推奨シーン： タスク方向が確定している場合
有効化方法：Shift + Tab で切替
Escape で一時停止可能推奨シーン： 複雑なアーキテクチャ決定
使用方法：最初に「まず計画を立ててください」と指示
例えば、src/ ディレクトリで起動すると、親ディレクトリの設定ファイルが見えません。
git checkout -b feature/new-feature
万が一うまくいかなかった場合、git reset で簡単にロールバックできます。
設定は以下で管理できます：
/permissions
定期的に使用状況を確認しましょう。大規模なコードベースの分析は多くのトークンを消費します。
❌ 良くない例：「エラーが出ています」 ✅ 良い例：「以下のエラーが出ています： TypeError: Cannot read property ‘map’ of undefined at User.getNames (src/models/User.js:45:12) at processUserList (src/utils/processor.js:23:5)」
常に以下を確認してください：
プロジェクトの根ディレクトリに claude.md を配置すると、Claude が自動的にそれを読み込みます。
ファイルに記載する内容：
特に複雑な機能では、Claude に最初に計画を立てさせ、確認してからコーディングを始めます。
特にチーム開発では、重要な操作の自動実行は避けてください。
複数の独立したタスクは、別々に処理させる方が良い結果になります。
「シンプルに作って」という指示でも、エラーハンドリングは必須です。
Claude が生成したコードでも、本番環境には入れる前にテストしてください。
「ユーザー管理機能を作ってください」
「Express.js と MongoDB を使用してユーザー管理 REST API を実装してください。 機能： - ユーザー登録（メール、パスワード、名前） - ログイン（JWT トークン返却） - ユーザー情報更新 - ユーザー削除（管理者のみ） パスワードは bcrypt でハッシュ化してください。」
$ cd src/ $ claude
この場合、src/ ディレクトリのファイルのみが対象になります。設定ファイルや他のディレクトリが見えません。
$ cd /path/to/project # プロジェクトルート $ claude
$ git checkout -b feature/new-feature $ claude [Claude がコードを編集] $ git add . $ git commit -m “Add new feature” $ git push origin feature/new-feature [PR を作成して確認]
claude --dangerously-skip-permissions
この設定は Claude に完全な権限を与えてしまいます。
Claude がコードを生成 ↓ テストをパス ↓ すぐに本番にマージ
Claude がコードを生成 ↓ 手動でコードレビュー ↓ セキュリティチェック ↓ パフォーマンス検証 ↓ テストをパス ↓ PR レビュー（別の人） ↓ 本番にマージ
Claude がコードを生成 → すぐにマージ
プロジェクトの .claude/commands フォルダにマークダウンファイルを保存できます。
ファイル：.claude/commands/ask-architecture.md
You are a Senior Systems Architect. When discussing system design: - Evaluate system boundaries and interfaces - Recommend architectural patterns - Consider scalability and performance - Provide strategic guidance - Consider cost implications Always ask clarifying questions if needed.
使用方法：@ask-architecture 我々のマイクロサービスアーキテクチャでスケーリングの問題が発生しています
外部データソースとの統合で Claude Code を拡張できます。
/mcp # 対話的に設定 /mcp list # 設定済みサービスを表示 /mcp add# サービスを追加
異なる役割を持つ専門的な AI アシスタントを作成できます。
/agents
Claude がガイドします。
$ git checkout -b feature/oauth-auth $ claude
指示：「プロジェクトの構造を分析した上で、OAuth2 認証を実装するための具体的なステップを列挙してください。現在は Redis セッション管理を使用しています。」
チームでその計画が正しいか確認。修正が必要なら指摘。
例：「計画は良いですが、JWT トークンの有効期限は 24 時間にしてください」
指示：「計画に従って実装してください。詳細なエラーハンドリングとログを含めてください。」
指示：「OAuth2 フロー全体のユニットテストを作成してください。成功ケース、失敗ケース、エッジケースをカバーしてください。」
$ git add . $ git commit -m “Add OAuth2 authentication” $ git push origin feature/oauth-auth
PR を作成してレビューを待つ
完全なエラーメッセージ、スタックトレース、再現手順を用意
指示：「以下のエラーが発生しています。原因を特定し、修正コードを提案してください。[スタックトレースをペースト]」
指示：「このバグを再現するテストを作成し、修正後に成功することを確認してください。」
指示：「このコードのセキュリティ、パフォーマンス、保守性をレビューしてください。改善提案をお願いします。[ファイルをペースト]」
Claude が以下を提供します：
プロジェクトルートに claude.md ファイルを作成：
# Claude Code Team Guidelines ## コーディング規約 - 関数の最大長：50行 - 変数名：キャメルケース - 定数名：スネークケース大文字 ## プロジェクト構造 src/ ├── controllers/ # API ハンドラ ├── models/ # データモデル ├── services/ # ビジネスロジック ├── middleware/ # 共通処理 └── utils/ # ユーティリティ ## テスト要件 - 全ユニットテストはカバレッジ 80% 以上 - 統合テストは主要ワークフロー必須 - エッジケースをカバー ## Git ワークフロー - main ブランチは常にテスト通過状態 - 機能は feature/ ブランチで開発 - PR は 1 人以上のレビューが必須 ## デプロイメント - 本番：毎週木曜 14:00 JST - ステージング：自動デプロイ
チーム全体で同じ統合を使用するため、設定ファイルをバージョン管理に含める。
チームの役割別にサブエージェントを作成：
| レベル | 許可される操作 | 禁止される操作 |
|---|---|---|
| 新人開発者 | コード理解、バグ修正、単純な機能 | 自動受け入れモード、Git 直接操作 |
| 経験者 | すべての操作 | なし |
| リード | すべての操作 | なし |
特に第1〜5部は必読
例：ユーザー登録フォームの作成、エラーメッセージの改善など
Claude にエラーを分析させ、修正案を確認し、テストさせる
計画フェーズ → 実装 → テスト → PR のフルワークフロー
高度な機能、Sub-Agents、カスタムコマンドを探索
A: Git を使用していれば、いつでも git reset でロールバックできます。必ず新しいブランチで作業してください。
A: 重要なコードは常に確認してください。フォーマッティングやLintの自動修正など、低リスクの操作は信頼できます。
A: Claude は質問で返してきます。より詳細な説明を提供してください。
A: 不要なファイルを .claudeignore で除外し、特定のファイルに焦点を絞った指示を出してください。
A: チーム開発では便利ですが、初心者には不要です。基本を習得してから導入してください。
A: Anthropic へのフィードバックは歓迎されます。ただし、本番環境には入れないでください。
/login$ git diff # 変更内容を確認 $ git reset –hard # 変更をキャンセル
最初は「Claude Code ですべてを自動化したい」という気持ちになるでしょう。でも、その気持ちを抑えて、小さなタスクから始めてください。基本を習得すれば、より効率的に Claude Code を活用できるようになります。焦らず、段階的に学習してください。